Improve doc of gtk_style_context_invalidate()

https://bugzilla.gnome.org/show_bug.cgi?id=708583

diff --git a/gtk/gtkstylecontext.c b/gtk/gtkstylecontext.c
index cf7ea20f2dd2e4b3a59354bd6099d83497972f23..d45157db267ba94f99cdcc4e8eaf2e41cbeb1c5d 100644 (file)
--- a/gtk/gtkstylecontext.c
+++ b/gtk/gtkstylecontext.c
@@ -3382,11 +3382,8 @@ _gtk_style_context_queue_invalidate (GtkStyleContext *context,
  * @context: a #GtkStyleContext.
  *
  * Invalidates @context style information, so it will be reconstructed
- * again.
- *
- * If you're using a #GtkStyleContext returned from
- * gtk_widget_get_style_context(), you do not need to
- * call this yourself.
+ * again. It is useful if you modify the @context and need the new
+ * information immediately.
  *
  * Since: 3.0
  **/